home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util4 / bootgg03.lha / BG / BootGauge.doc < prev    next >
Text File  |  1995-11-02  |  8KB  |  415 lines
  1. Short:    Shows a gauge bar while booting, BETA !!!
  2. Uploader: Tcn@lbcmbx.in-berlin.de (Timo C. Nentwig)
  3. Author:   Tcn@lbcmbx.in-berlin.de (Timo C. Nentwig)
  4. Type:     util/boot
  5.  
  6.  
  7. NAME
  8.  
  9.   BootGauge 0.3
  10.   Copyright © 1995 by Timo C. Nentwig
  11.  
  12.  
  13.  
  14.  
  15. STATUS
  16.  
  17.   SysBoot is Giftware ! That means that you (the user of BG) MUST send
  18.   me a nice gift if for use BG ;-)
  19.  
  20.  
  21.  
  22.  
  23. REQUIREMENTS
  24.  
  25.   AmigaOS 2+
  26.   4/5Bit Screeenmode
  27.  
  28.  
  29.  
  30.  
  31. PURPOSE
  32.  
  33.  
  34.   My A4k30 needs about 1min to boot. It was boring  to  wait  all  the
  35.   time and just seeing a black screen.
  36.  
  37.   I tried a boot picture but I wasn't much more fun.
  38.  
  39.   I had long time dreamed to have such tool but when I  saw  that  the
  40.   MAC  (Sys7.5.1+)  had  a  boot gauge bar I began to develop an equal
  41.   program.
  42.  
  43.   BootGauge opens its own window on its own  screen  and  executes  an
  44.   alternative startup-sequence.
  45.  
  46.   So it displays a gauge bar while booting.
  47.  
  48.  
  49.  
  50. USAGE
  51.  
  52.   Your Startup-Sequence could look so:
  53.  
  54.  
  55.    SysIHack 18 16 18 15 3DLOOK HBORDER 3 VBORDER 3        ; 13 pt font
  56.    PrePareEmul >NIL:                                      ; ShapeShifter
  57.    SetPatch >NIL:
  58.  
  59.    Assign ENV: ENVARC:
  60.    DH1:Devs/Monitors/Spectrum
  61.  
  62.    Bootgauge -sx 600 -sy 100 -id 1078067204 -seq s:amiga-startup >nil:
  63.  
  64.    endcli >nil:
  65.  
  66.  
  67.  
  68.    This will force BG to execute s:amiga-startup.
  69.  
  70.  
  71.  
  72.  
  73. OPTIONS
  74.  
  75.  
  76.   The advantage of BG is that it is very configurable.
  77.  
  78.  
  79.               BootGauge <options>
  80.  
  81.  
  82.   To get a short help enter:
  83.  
  84.             BootGauge ? or BootGauge
  85.  
  86.  
  87.   EXAMPLE
  88.  
  89.  
  90.   Bootgauge -sx 600 -sy 100 -id 1078067204 -seq s:amiga-startup >nil:
  91.  
  92.  
  93.  
  94.   OPTIONS
  95.  
  96.  
  97.   01) ModeID        : -modeid <modeid>  or -id <modeid>
  98.  
  99.               Set the BG screenmode. Get the <modeid> by
  100.               typing:
  101.  
  102.                 BootGauge -getid
  103.  
  104.  
  105.   02) Sequence      : -seq <sequence> or -sequence <sequence>
  106.  
  107.               <sequence> is the startup-sequence that should
  108.               be executed by BG.
  109.  
  110.  
  111.   03) GaugeColor    : -gc <0-31> or -gaugecolor <0-31>
  112.  
  113.               Set the color of the gauge bar.
  114.  
  115.  
  116.   04) GaugeBackColor: -gbc <0-31> or -gaugebackcolor <0-31>
  117.  
  118.               Set the background color of the gauge bar.
  119.  
  120.  
  121.   05) WindowColor   : -wc <0-31> or -windowcolor <0-31>
  122.  
  123.               Set the color of the window.
  124.  
  125.  
  126.  
  127.   06) ScreenColor   : -sc <1-31> or -screencolor <1-31>
  128.  
  129.               Set the color of the screen.
  130.  
  131.  
  132.   07) ScreenPattern : -spat or -screenpat
  133.  
  134.               Set a background pattern for the screen instead
  135.               of a simple color.
  136.  
  137.  
  138.   08) X size        : -sx <x> or -sizex <x>
  139.  
  140.               Set the window's x size.
  141.  
  142.  
  143.   08) Y size        : -sy <x> or -sizey <x>
  144.  
  145.               Set the window's y size.
  146.  
  147.  
  148.   09) NoPattern     : -nopat or -nopattern
  149.  
  150.               Do not use a pattern in the window.
  151.  
  152.  
  153.   10) NoRaster      : -norast or -noraster
  154.  
  155.               Disable raster color filling of screen.
  156.  
  157.  
  158.   11) NoScale       : -nosl or -noscale
  159.  
  160.               Do not display gauge bar's scale.
  161.  
  162.  
  163.   12) NoDebug       : -nodb or -nodebug
  164.  
  165.               Do not display any requester/warnings.
  166.  
  167.  
  168.   13) NoDisplayCmd  : -nodc or -nodisplaycmd
  169.  
  170.               Do not display the current command in the
  171.               title bar.
  172.  
  173.   14) ECS Mode      : -emod or -ecsmode
  174.  
  175.               Use only a 4 bit (instead of 5 bit) screen. For
  176.               compatibility with ocs/ecs Amigas.
  177.  
  178.  
  179.   15) GetModeID     : -getmodeid or -getid
  180.  
  181.               Sub-program to get the id of a screenmode.
  182.  
  183.  
  184.   16) Test          : -t or -test
  185.  
  186.               Do not execute the current line of <sequence>.
  187.  
  188.  
  189.  
  190. TODO
  191.  
  192.   Please send me patterns for the window/screen if you have any !!!
  193.  
  194.   ... contact me !
  195.  
  196.  
  197.  
  198. EXAMPLE
  199.  
  200.  
  201.   ** s:startup-sequence
  202.      ------------------
  203.  
  204.     SysIHack 18 16 18 15 3DLOOK HBORDER 3 VBORDER 3        ; 13 pt font
  205.     PrePareEmul >NIL:                                      ; ShapeShifter
  206.     SetPatch >NIL:
  207.  
  208.     Assign ENV: ENVARC:
  209.     DH1:Devs/Monitors/Spectrum
  210.  
  211.     ;SysBoot -id 1078067204 -aimg 4 -t 15 -fc 28 -amicmd "Bootgauge -gc 9 -id 1078067204 -seq s:amiga-startup" -aplcmd "execute s:mac-startup"
  212.  
  213.     Bootgauge -sx 600 -sy 100 -id 1078067204 -seq s:amiga-startup >nil:
  214.  
  215.     endcli >nil:
  216.  
  217.  
  218.   ** s:amiga-startup
  219.      ---------------
  220.  
  221.     PatchControl ARQ
  222.  
  223.     Relabel drive RAM: name "Ram-Disk"
  224.     Copy     >NIL: SYS:S/RAM.info RAM:Disk.info
  225.  
  226.     MakeDir  >NIL: Ram:Env Ram:T Ram:Clipboards
  227.     Copy     >NIL: ENVARC: RAM:ENV ALL NOREQ
  228.  
  229.  
  230.  
  231.  
  232.     ; System Assigns - - - - - - - - - - - - - - - - - -
  233.  
  234.  
  235.     Execute     S:Assign/System.assign
  236.  
  237.  
  238.  
  239.     ; KingCon - - - - - - - - - - - - - - - - - - - - - -
  240.  
  241.     Assign    CON: Dismount                                ; use KingCon instead of Con:
  242.     Assign    RAW: Dismount                                ; use KingCon instead of Raw:
  243.  
  244.  
  245.  
  246.  
  247.     ; Drivers - - - - - - - - - - - - - - - - - - - - - -
  248.  
  249.     Mount    >NIL: DEVS:DOSDrivers/~(#?.info)
  250.     MFSMount       DEVS:DOSDrivers/~(#?.info)
  251.  
  252.           DEVS:Monitors/VGAOnly
  253.     List     >NIL: DEVS:Monitors/~(#?.info|Spectrum) to T:Monitors LFORMAT "DEVS:Monitors/%s"
  254.     Execute  >NIL:    T:Monitors
  255.     Delete   >NIL:    T:Monitors
  256.  
  257.  
  258.     RUN      >NIL: MagicWB-Demon 4,123,123,123 5,175,175,175 6,170,144,124 7,255,169,151 ; arg "xen" -> Gag
  259.  
  260.  
  261.  
  262.  
  263.     ; User Assigns - - - - - - - - - - - - - - - - - - -
  264.  
  265.     Execute     S:Assign/Directory.assign
  266.  
  267.     Execute     S:Assign/Art.assign
  268.     Execute     S:Assign/Dev.assign
  269.     Execute     S:Assign/DFA.assign
  270.     Execute     S:Assign/HD.assign
  271.     Execute     S:Assign/MagicWB.assign
  272.     Execute     S:Assign/Misc.assign
  273.     Execute     S:Assign/MUI.assign
  274.     Execute     S:Assign/Music.assign
  275.     Execute     S:Assign/Text.assign
  276.     Execute     S:Assign/UMS_UUCP.assign
  277.  
  278.  
  279.  
  280.  
  281.     ; System - - - - - - - - - - - - - - - - - - - - - -
  282.  
  283.     AddDataTypes REFRESH QUIET
  284.     IPrefs
  285.  
  286.  
  287.  
  288.     ; Startup-Seqs - - - - - - - - - - - - - - - - - - -
  289.  
  290.     Execute     S:User-Startup
  291.     Execute     S:Tools-Startup
  292.  
  293.  
  294.     Execute     S:Path-Startup
  295.  
  296.     LoadWB CLEANUP
  297.  
  298.  
  299.  
  300.  
  301. NOTE
  302.  
  303.   BootGauge works line orientated. This means that BG reads <sequence>
  304.   line  for line and executes every line by using system(). That means
  305.   for example that your can't  use  if  blocks  or  jumps  marks  like
  306.   lab/skip.
  307.  
  308.   * BG is not able to handle alias, path etc.
  309.   * BG is not able to handle if blocks, lab/skip etc.
  310.   * several other commands cannot be executed or won't have any
  311.     effect.
  312.  
  313.   * Test your system before really using BG, e.g. with:
  314.  
  315.     BootGauge -test -seq s:amiga-startup.
  316.  
  317.  
  318.  
  319.    --BUG --
  320.  
  321.   BG's debug mode is not able to handle strings, yet. This means  that
  322.   there's no difference between:
  323.  
  324.                    path ram:
  325.  
  326.        and
  327.  
  328.                 echo "path ram:"
  329.  
  330.   You'll get a request that BG is not able to handle path !
  331.  
  332.   This will be fixed as soon as possible.
  333.  
  334.  
  335.  
  336.   I did not test BG very much but it works with my configuration.
  337.  
  338.   I still look for beta testers. You want to test BG ? Please  contact
  339.   me !!
  340.  
  341.  
  342.   BTW: I'm sorry if this doc is full of mistakes but  I  do  not  have
  343.   very much time to write it.
  344.  
  345.  
  346.  
  347. HISTORY
  348.  
  349.   CNG = CHANGED
  350.   ADD = ADDED
  351.   REM = REMOVED
  352.   FIX = FIXED
  353.  
  354.   15 Sep 1995  -  0.1
  355.  
  356.     first runable version
  357.  
  358.  
  359.   17 Sep 1995  -  0.2
  360.  
  361.     add: background image
  362.     add: -gc/-gaugecolor
  363.     add: background pattern
  364.     add: -sc/-screencolor
  365.     add: -nosr/-noscreenraster
  366.     add: -test
  367.     cng: background image
  368.     add: -cv/-viewcommand
  369.     add: FAILED_OPENSEQ
  370.  
  371.  
  372.   20 Okt 1995  -  0.3
  373.  
  374.     add: check: skip, failat, path
  375.     cng: set "BootGauge ..." before everything in titlebar
  376.     add: if/endif handling
  377.     cng: image handling
  378.     add: window's x/y size is configureable
  379.      IText and gauge bar adapts automatically
  380.     add: gauge bar scale
  381.     add: -nopat/-nopattern
  382.     add: -wc/-windowcolor
  383.     add: -nosl/-noscale
  384.     add: -gbc/-gaugebackcolor
  385.     add: -getid/-getmodeid
  386.     fix: check if bg_win is too large for bg_scr
  387.     fix: if handling now correct
  388.     fix: cmd handling now correct
  389.     add: skip/lab handling
  390.     cng: image
  391.     imp: palette, using now 32bit palette
  392.     add: -nodb/-nodebug
  393.  
  394.     ** 01 Nov 1995 **
  395.  
  396.     add: -emod/-ecsmode
  397.     add: test if line is a comment
  398.  
  399.   --  <initial release>  --
  400.  
  401.  
  402.  
  403. AUTHOR
  404.  
  405.   Timo C. Nentwig
  406.   Edelhofdamm 35
  407.   13465 Berlin
  408.  
  409.   Tcn@lbcmbx.in-berlin.de
  410.  
  411.   Comments, suggestions, bugreports etc. to the address above.
  412.  
  413.  
  414.  
  415.